Named map of every layer of the operating system: connectors that bring data in, skills that transform it, the vault that stores it, engines that run on schedule, and renders that present it back. With actual names, paths, and data flow.
Data moves left to right. Connectors pull from outside systems; skills transform; the vault stores; engines reconcile in the background; renders present back to humans.
External systems Claude can read from or write to. Each is a Model Context Protocol server with named tools.
| Connector | What it accesses | Key named tools | Status |
|---|---|---|---|
| Obsidian Vault (BenAI Relay) | The vault itself. Authoritative store. Syncs to mobile + web + remote Claude clients. | vault_read, vault_write, vault_append, vault_list, vault_search, vault_move, vault_delete, vault_folders, vault_relays |
live |
| Google Drive | Google Drive files, Docs, Sheets. Gemini Notes Docs (auto-generated by Meet) live here. | search_files, read_file_content, get_file_metadata, list_recent_files, create_file, copy_file, download_file_content, get_file_permissions |
live |
| Slack | Team comms layer per Surface Decision V2. Audio notes + daily digests + async responses. | slack_send_message, slack_read_channel, slack_read_thread, slack_search_public, slack_create_canvas, slack_schedule_message, slack_search_users, slack_list_channel_members |
live |
| Notion | Team ops-side per Surface V2: kanban, calendar, task DBs, blockers, comments. Synced from vault. | notion-create-pages, notion-update-page, notion-search, notion-fetch, notion-create-database, notion-create-view, notion-get-comments, notion-create-comment |
live |
| Fireflies | AI meeting note-taker. Joins Google Meet calls, transcribes. Newly added (May 2026). | fireflies_get_transcript, fireflies_get_summary, fireflies_search, fireflies_get_analytics, fireflies_create_soundbite, fireflies_get_active_meetings |
live |
| Gmail | Email inbox. Drafts, labels, threads, search. | search_threads, get_thread, create_draft, list_drafts, label_thread, label_message, create_label, list_labels |
live |
| Google Calendar | Calendar events, scheduling, attendees. | list_events, get_event, create_event, update_event, delete_event, suggest_time, respond_to_event, list_calendars |
live |
| Cowork | The Cowork desktop app itself. Artefact persistence, file delete, folder selection. | create_artifact, update_artifact, list_artifacts, read_widget_context, allow_cowork_file_delete, request_cowork_directory |
live |
| Claude in Chrome | Browser automation. JS-rendered pages, form input, screenshots, network/console reading. | navigate, get_page_text, computer, javascript_tool, form_input, read_console_messages, read_network_requests, find, browser_batch |
live |
| Scheduled Tasks | Cron-style scheduler. Recurring or one-shot future Claude sessions independent of Mac state. | create_scheduled_task, update_scheduled_task, list_scheduled_tasks |
live |
| MCP Registry | Anthropic's connector registry. Discover and suggest MCPs Tom hasn't installed yet. | search_mcp_registry, list_connectors, suggest_connectors |
live |
Three categories. Vault-internal skills live at Skills/{name}/ and fire via verbal trigger or canon-registered shortcut. External mirrors are symlinks into Skills/external/ from ~/.claude/skills/ per canon Rule 29. Plugin skills are loaded by Cowork at session start and appear in <available_skills>.
| Name | Path | What it does | Trigger |
|---|---|---|---|
| transcript-ingest | Skills/transcript-ingest/ |
10-pass protocol: extract entities/decisions/framings/tasks/projects/considerations/context from a transcript and route into vault. | intake this transcript |
| diagnose | Skills/diagnose/ |
Disciplined diagnosis loop for bugs and performance regressions: reproduce, minimise, hypothesise, instrument, fix. | diagnose this |
| grill-with-docs | Skills/grill-with-docs/ |
Stress-test a plan against existing domain model + documented decisions; update CONTEXT.md inline. | explicit call |
| handoff | Skills/handoff/ |
Compact a conversation into a handoff doc for another agent. | explicit call |
| internal-comms | Skills/internal-comms/ |
House formats for internal comms: status reports, leadership updates, FAQs, incident reports. | "write a status report" etc |
| karpathy-guidelines | Skills/karpathy-guidelines/ |
Coding discipline: think before coding, simplicity, surgical changes, goal-driven execution. | auto on code tasks |
| triage | Skills/triage/ |
State machine for triaging incoming issues, bugs, feature requests; preps for AFK agent. | "triage this" |
| vault-operator | Skills/vault-operator/ |
Scheduled vault-operator profile prompt. Runs the OS on cadence per the operator schedule. | scheduled task |
| Name | What it does | Source |
|---|---|---|
| boardroom | Boardroom-style decision support (raise prep + investor conversations) | cloudflare/boardroom_skills |
| brainstorming | Structured idea generation | expert-skills |
| brand-discover | Brand voice discovery (read existing assets, infer voice) | knowledge-work-plugins |
| brand-voice-enforcement | Apply brand voice rules to drafts | knowledge-work-plugins |
| caveman | Adversarial review of LLM output (catches over-helpfulness) | caveman repo |
| deep-research | Multi-step web research with structured output | claude-deep-research-skill |
| dispatching-parallel-agents | Orchestrate multiple subagents on parallel tasks | expert-skills |
| expert-skills | Meta-skill containing the expert-skills suite | expert-skills |
| grill-me | Adversarial grilling of a proposal or plan | superpowers / pocock |
| handoff (mirror) | External handoff skill (paired with vault handoff) | expert-skills |
| premortem | Pre-mortem analysis: imagine the plan failed, work backwards | premortem repo |
| subagent-driven-development | Use subagents to drive a development task end-to-end | expert-skills |
| to-prd | Convert a rough brief into a PRD | expert-skills |
| verification-before-completion | Force verification step before marking a task done | expert-skills |
| writing-plans | Structured plan-writing skill | expert-skills |
| zoom-out | Force a step back from detail to see the larger frame | expert-skills |
From <available_skills> at session start. Three plugin namespaces visible:
| Skill | What it does | Triggered by |
|---|---|---|
| anthropic-skills:docx | Create / read / edit Word docs (.docx) | "word doc" or .docx mention |
| anthropic-skills:pptx | Slide decks (.pptx) read and write | "deck", "slides", "presentation" |
| anthropic-skills:xlsx | Spreadsheets (.xlsx, .csv, .tsv) read and edit | "spreadsheet", "excel" |
| anthropic-skills:pdf | PDF read, write, merge, OCR, forms | "PDF" or .pdf mention |
| anthropic-skills:canvas-design | Visual art in PNG/PDF (posters, designs) | "poster", "design" |
| anthropic-skills:web-artifacts-builder | Complex Claude.ai HTML artefacts (React + Tailwind + shadcn) | "artefact build" |
| anthropic-skills:internal-comms | Status reports, leadership updates, FAQs, incident reports | "write a status report" |
| anthropic-skills:mcp-builder | Build MCP servers (Python FastMCP or Node/TypeScript) | "build an MCP" |
| anthropic-skills:handoff | Compact conversation into handoff doc | "handoff to next session" |
| anthropic-skills:triage | State machine for triaging issues | "triage this" |
| anthropic-skills:skill-creator | Create new skills, optimise descriptions, run evals | "create a skill" |
| anthropic-skills:diagnose | Bug + perf-regression diagnosis loop | "diagnose this", "debug this" |
| anthropic-skills:karpathy-guidelines | Coding discipline rules (auto on code tasks) | code tasks |
| anthropic-skills:setup-cowork | Guided Cowork onboarding (plugins, connectors, skills) | "set up Cowork" |
| anthropic-skills:consolidate-memory | Merge / prune memory files; fix stale facts | "consolidate memory" |
| obsidian:os-mcp | Deploy Relay MCP to Railway; give Claude vault access | "set up the OS MCP" |
| obsidian:os-operator | Build + schedule a personalized Operator prompt that runs the second-brain on cadence | "operate my second brain" |
| obsidian:os-optimizer | Framework-driven vault audit (9 frameworks F1-F9) | "optimize vault" |
| obsidian:os-setup | Bootstrap BenAI OS vault structure + onboarding | "set up", "bootstrap" |
| obsidian:team-os | Install BenAI Relay fork (RBAC + team-vault sharing) | "set up team OS" |
The canonical store. Every piece of information has a designated home per the Knowledge Routing table in root CLAUDE.md. No catch-all; if routing is unclear, default to _scratch/ with route: pending.
| Folder | What lives here | Owner pattern |
|---|---|---|
| Context/ | Static-ish operating context: operator prefs, org info, strategy, ICP, pain-points, services, brand, infrastructure, stakeholders, team, market, benai-relay | tom-king (canonical) |
| Intelligence/ | Meetings, decisions, competitors, market, processes, research, inbox. Time-stamped, immutable records. | tom-king |
| Projects/ | Each named project gets a folder: Unlock, Cloudworkz-OS, Sales-Loop, Investor-Raise, Yachai, booker-hub-split, cloudworkz-hub, OS-Optimization-2026-Q2, EUK-Website, SafeSchool, Wolter, etc. | per project |
| Team/ | Profiles: cloudworkz/Profiles/{name} for team, External/contractors/{name} for contractors. Each has Daily/, task-list/Tasks.md, Outbox/, sub-schedules/. | per person |
| Atomic-System/ | Customer-facing component library, ships 11 June 2026. | Claudia Chavez |
| Branding/ | Brand assets, design system, visual identity. Populate-first per 24 May decision. | Claudia Chavez |
| BrainBox/ | Developed ideas as HTML presentations + source.md pairs. Per-slug folders. | tom-king |
| Departments/ | Department charters, KPIs, SOPs per department. | per department |
| Onboarding/ | Onboarding docs per role / per person. | tom-king |
| Resources/ | Reusable content: frameworks, templates, engines, renders, proposed-canon-patches. | tom-king |
| Skills/ | Vault-internal skills + external mirrors. Skill-specific reference material. | tom-king |
| Daily/ | Org-level Daily/ (deprecated for canon writes; profile Daily/ is canonical). | deprecated |
_scratch/ | TTL-30d working artefacts; default routing for unclassified outputs (Rule 27). | tom-king |
CW — Command/, CW — Finance & Reporting/, CW — Marketing/, Live Artifact - Strategy and Team Clouds/ | Legacy reference. Read-only. Pre-migration canonical layer (3929 files combined). | read-only |
The folder list above tells you WHERE things go. The matrix below tells you WHAT goes where, WHO writes it, and HOW each information type is identified by its frontmatter type: value.
Reading order: the canonical routing table first (the contract for every information type), then generated outputs (what Claude produces in-session), then the sub-folder inventory inside each major folder (what's actually on disk), then the cross-cutting matrices (skills and engines mapped to routes), then three end-to-end lifecycles showing how the matrix is exercised in practice.
From root CLAUDE.md § Knowledge Routing. Every named information type has exactly one home. No catch-all. If routing is unclear, default is _scratch/ with frontmatter route: pending per canon Rule 27.
| Information type | Canonical route | Owner pattern |
|---|---|---|
| Operator preferences, style, habits | Context/operator.md | tom-king |
| Org structure, company info, products | Context/organization.md | tom-king |
| Strategy, OKRs, quarterly goals | Context/strategy.md | tom-king |
| Services, products, revenue lines | Context/services.md | tom-king |
| ICP / customer profile | Context/icp.md | tom-king |
| Customer + operator pain points | Context/pain-points.md | tom-king |
| Tool stack, integrations | Context/infrastructure.md | tom-king |
| Brand voice, tone, messaging | Context/brand.md | tom-king |
| Brand assets, design system | Branding/ | Claudia Chavez |
| Atomic system component library | Atomic-System/ | Claudia Chavez |
| Developed ideas (HTML presentations) | BrainBox/{slug}/ | tom-king |
| Vendor / partner / investor info | Context/stakeholders.md | tom-king |
| Team roster, agreements | Context/team.md | tom-king |
| Department info, charter, KPIs | Departments/{name}/ | per department |
| Person profile, daily notes, tasks | Team/cloudworkz/Profiles/{name}/ | that person |
| Contractor profile | Team/External/contractors/{name}/ | that contractor |
| Project info, briefs, retros | Projects/{name}/ | per project |
| Meetings, decisions, competitors, market, processes, research, audit-spawned items | Intelligence/ | tom-king |
| Onboarding docs | Onboarding/{name}.md | tom-king |
| Reusable frameworks, prompts, templates, engines, renders | Resources/ | tom-king |
| Skill-specific references | Skills/{skill-name}/ | tom-king |
| Tasks, action items | active profile's task-list/Tasks.md | that profile |
| Personal daily note | active profile's Daily/YYYY-MM-DD.md | that profile |
| Canon user corrections | .claude/rules/cloudworkz-canon.md | auto-loaded |
| Rules for assistant behaviour | root CLAUDE.md | tom-king |
Same idea, narrower scope: what Claude produces in-session, where it lands, what type: frontmatter value identifies it. Every generated artefact carries type, project, owner, status, plus a your_move: line. No frontmatter, no save: default routing to _scratch/.
| Generated artefact | Route to | type: value |
|---|---|---|
| Draft to send (email, post, message) | active profile's Outbox/ | draft |
| Report / memo for review | Departments/{name}/reports/ or Projects/{name}/reports/ | report |
| Research brief | Intelligence/research/ | research |
| Meeting notes | Intelligence/meetings/ | meeting |
| Decision record | Intelligence/decisions/ | decision |
| Idea presentation (developed) | BrainBox/{slug}/ | brainbox-entry |
| Idea draft (uncommitted) | BrainBox/_drafts/{slug}.md | brainbox-draft |
| Working memo / scratch | _scratch/ (TTL 30 days) | scratch |
| Task spawned by output | active profile's task-list/Tasks.md (entry, not file) | n/a (Obsidian-task format) |
| Render (hosted HTML) | Resources/renders/{name}/ | render |
| Folder index | that folder's CLAUDE.md | folder-claude |
Drill-down into the sub-folders + file inventory inside each top-level vault folder. This is the second resolution layer below the 17-folder list above.
| Sub-folder | Information type | Filename pattern | Written by |
|---|---|---|---|
meetings/ | Meeting notes (source of record for any meeting) | YYYY-MM-DD-{slug}.md | transcript-ingest skill |
decisions/ | Decision records, immutable. Wikilink trail for supersession. | YYYY-MM-DD-{slug}-V{n}.md | transcript-ingest Pass 2/2b or manual |
research/ | Research briefs, frameworks-in-development, V-numbered investigations | YYYY-MM-DD-{slug}-V{n}.md | manual deep-research or transcript Pass 5 |
competitors/ | Per-competitor intel, signals, threat assessment | {competitor-slug}.md | transcript Pass 5c or manual |
market/ | Market intel (Tom's market signals, trends, sector data) | {market-slug}.md | transcript Pass 5c or manual |
processes/ | Cross-cutting process docs (org-wide, not department SOPs) | {process-slug}.md | manual |
inbox/ | Audit-spawned items (CHECK-* files), Slack-ingest landings, Whisper transcriptions, untriaged signals | CHECK-YYYY-MM-DD-*.md, mixed | daily-audit, slack-ingest, manual |
considerations/ (lazy-created) | Options being weighed without resolution. Distinct from open questions and decisions. Created on first need by transcript-ingest Pass 5b. | YYYY-MM-DD-{slug}.md | transcript-ingest Pass 5b |
| File | What it holds |
|---|---|
operator.md | Tom's preferences, style rules, working habits |
organization.md | Cloudworkz/Unlock org structure, product hierarchy |
strategy.md | OKRs, strategic anchors (Unlock 1 Oct 2026, raise April 2027, OS Oct 2027), dated strategy updates |
services.md | Cloudworkz services + revenue lines (Unlock, OS, Atomic-System, Yachay, etc.) |
icp.md | Ideal customer profile (UK HNW segment, P-codes x engines) |
pain-points.md | Customer pain points + operator/internal pain points (Tom-as-bottleneck, etc.) |
infrastructure.md | Tool stack: Cowork, BenAI Relay, Supabase, Cloudflare, Notion, Drive, Slack, Fireflies |
brand.md | Voice rules, tone, canonical CLOUDZ definition (per canon Rule 9c) |
stakeholders.md | Investors, advisors (Tony Vine-Lott), partners, vendors |
team.md | Team roster (canonical names per canon Rule 9), reporting lines |
market.md | Market context (segments, sizing, sector dynamics) |
benai-relay.md | BenAI Relay sync architecture reference, State A/B/C semantics |
Per-project layout: each Projects/{Name}/ folder contains README.md (project orientation), CLAUDE.md (folder-claude frontmatter + folder conventions), optionally brief-V{n}.md, reports/, retros/, _archive/. Active projects on disk:
| Project | Workstream | Status / ship |
|---|---|---|
Unlock/ | UK HNW decision-support platform (subscription) | ships 1 Oct 2026 |
Cloudworkz-OS/ | Operating layer powering Unlock | commercialises Oct 2027 |
Investor-Raise/ | £6.5M raise first close | April 2027 |
Sales-Loop/ | Tom-owned sales loop (daily activate) | activated 2026-05-25 |
OS-Optimization-2026-Q2/ | Audit-pass + Phase-2 prep for the OS itself | ongoing |
Team-Surface/ | Four-surface architecture build (HTML + Notion + Slack + vault) | in flight |
Team-Rollout/ | Team rollout for vault + Notion + Slack architecture | in flight |
EUK-Website/ | EUK website workstream | in flight |
SafeSchool/ | SafeSchool engagement (legal context per canon Rule 7) | in flight |
Wolter/ | Wolter matter (instructed counsel) | in flight |
Yachai/ | Claudia Chavez sales / video / luxury-villa portfolio | ongoing |
booker-hub-split/ | Booker hub split workstream (Marie booker context) | in flight |
cloudworkz-hub/ | Cross-device workstation prototype | brief-V1 queued |
Roose-Design-Signoff/ | Roose design signoff workstream | in flight |
Unlock-Content-Brain/ | Unlock content brain workstream | in flight |
Unlock-Lead-Gen-Scripts/ | Unlock lead-gen script suite | in flight |
| Sub-path | What lives here |
|---|---|
{Name}.md | The person's profile (role, scope, context) |
Daily/YYYY-MM-DD.md | Per-day notes (canonical Daily; not root Daily/) |
task-list/Tasks.md | Canonical tasks for that person (Rule 22 split-path canon) |
Outbox/ | Drafts to send: emails, posts, messages |
sub-schedules/ | Per-person schedule notes (1-1s, recurring) |
payslips/ | Payslip + comp records (tom-king only) |
| Sub-folder | What lives here |
|---|---|
frameworks/ | Reusable frameworks, V-numbered briefs (bos-ecosystem-V1, sync-resilience-brief-V1, etc.) |
engines/ | Scheduled background processes (see Layer 4) |
renders/ | Hosted HTML renders (see Layer 5) |
templates/ | Reusable file templates (meeting notes, decision records, project briefs) |
principles/ | Operating principles, canonical statements |
companies/ | Per-company reference dossiers |
proposed-canon-patches/ | Queued canon proposals during V32 freeze (adoption resumes 2026-06-01) |
_archive/ | Archived Resources material (retired engines, deprecated renders) |
| Sub-path | What lives here |
|---|---|
CLAUDE.md | Folder index + full shortcut specs for "prepare for brainbox" and "add to brainbox" |
_template/ | Clone-from-here template (index.html + source.md) |
_drafts/{slug}.md | Prepared but uncommitted drafts (held until "add to brainbox" fires) |
{idea-slug}/ | One committed idea per folder: index.html + source.md + optional assets/ |
For each vault-internal skill or canon-registered shortcut, the routes it writes to. Read this as: "if I fire X, what gets touched."
| Skill or shortcut | Trigger | Routes written |
|---|---|---|
| transcript-ingest | intake this transcript |
Intelligence/meetings/ (source-of-record), Intelligence/decisions/ (Pass 2/2b), Intelligence/considerations/ (Pass 5b, lazy-created), Intelligence/research/ (Pass 5 stubs), Intelligence/competitors/ + Intelligence/market/ (Pass 5c), Context/strategy.md + Context/pain-points.md + Context/team.md + Context/services.md + Context/brand.md (Pass 5c appends), Projects/{name}/ (Pass 4 project-state), profile task-list/Tasks.md (Pass 4 owner-actions), profile Daily/ (chain mentions) |
| "prepare for brainbox" | prepare for brainbox |
BrainBox/_drafts/{slug}.md only (no commit; awaits "add to brainbox") |
| "add to brainbox" | add to brainbox |
BrainBox/{slug}/index.html + BrainBox/{slug}/source.md, appends Active ideas table in BrainBox/CLAUDE.md, deletes draft from BrainBox/_drafts/ if applicable |
| "signing off" | signing off |
Cowork artefact tom-king-signing-off (refresh), profile task-list/Tasks.md (Rule 21 close), 3-line chat reply |
| "clean up" | clean up |
No vault writes (chat-only code-block readout + dashboard reorder suggestion) |
| diagnose | diagnose this |
No vault writes by default; user routes the diagnosis output (typically Intelligence/research/ for the brief, profile Tasks.md for the fix) |
| internal-comms | "write a status report" etc | Profile Outbox/ (drafts) or Departments/{name}/reports/ |
| triage | triage this |
Relevant project's task-list or _scratch/ (state-machine output) |
| handoff | explicit | _scratch/handoff-{slug}.md or session-specific |
| karpathy-guidelines | auto on code tasks | No vault writes (behavioural rule; shapes how code edits happen) |
| grill-with-docs | explicit | Updates the target's CONTEXT.md inline; produces Intelligence/decisions/ ADRs when calls land |
| vault-operator | scheduled task | Per its prompt: Intelligence/inbox/ for findings, profile Tasks.md for queued items, profile Daily/ for the operator report |
For each engine, what it reads from and what it writes to. Engines run on launchd cadence per sync_all.sh orchestrator.
| Engine | Reads from | Writes to |
|---|---|---|
| daily-audit | Whole vault (10 checks: canon, frontmatter, sync state, engine health, em-dash drift, inventory) | Intelligence/inbox/CHECK-YYYY-MM-DD-*.md |
| daily-log-writer | Profile task-list/Tasks.md (any task moved to Done with today's date) | Profile Daily/YYYY-MM-DD.md ("Completed today" append) |
| em-dash-audit | Whole active vault (Rule 1 enforcement scan) | tom-king Daily/ (drift report) |
| master-tasks-html | Profile task-list/Tasks.md | External: master-tasks-tom.pages.dev (legacy, superseded by daily-triage artefact per Rule 21 V33) |
| notion-decisions-sync | Intelligence/decisions/ | External: Notion decisions DB (idempotent via content hash) |
| notion-tasks-sync | Profile task-list/Tasks.md AND per-person Notion kanban | Notion kanban (push); profile Tasks.md (pull for ticks; Rule 22 split-path) |
| os-dreaming | Whole vault (reflective pass for structural debt + name corrections) | Profile task-list/Tasks.md (audit-spawned tasks per Rule 24) |
| slack-ingest | Slack channels + DM threads (Whisper transcription for audio) | Intelligence/inbox/ (raw landings before triage) |
| team-html | Vault state (tasks by owner, project status, blockers) | External: team-surface.pages.dev |
| sync_all.sh | Orchestrator; runs every engine in order | No own writes; triggers each engine on the 15-min launchd cycle |
The matrices above are static. These three lifecycles show information moving through layers across time.
fireflies_get_transcript or Drive search_files. Skill auto-fires.Intelligence/decisions/YYYY-MM-DD-{slug}-V1.md with supersedes: wikilink to prior decisions if any.apply.Tasks.md, which notion-tasks-sync then propagates to the per-person Notion kanban.signing off shortcut at session close.task-list/Tasks.md with Rule 20 scoring (urgency emoji + e: + i: + imp:).Daily/YYYY-MM-DD.md.vault_read on next open (no snapshot rebuild per Rule 21 V33).BrainBox/_drafts/{slug}.md with type: brainbox-draft.BrainBox/{slug}/ with index.html + source.md from the template; appends Active ideas table in BrainBox/CLAUDE.md; deletes the draft.status: moves seed → developing → parked or promoted.Projects/{name}/ with a new project README; the BrainBox entry gets a promoted_to: frontmatter line pointing to the project. BrainBox entry stays as the originating thinking record.Live at Resources/engines/. Triggered by sync_all.sh on a launchd 15-minute cycle or by individual launchd plists. Each engine reads from the vault, transforms, writes back or to a render target.
| Engine | What it does | Cadence | I/O |
|---|---|---|---|
| daily-audit | Daily system audit: 10 checks covering canon compliance, frontmatter, sync state, engine health, em-dash drift, inventory. | daily 06:00 BST | vault → Intelligence/inbox/CHECK-YYYY-MM-DD-*.md |
| daily-log-writer | For every task moved to Done with today's date, appends "Completed today" entry to profile's Daily/ note. | every 15 min | Tasks.md → profile Daily/ |
| em-dash-audit | Scans active vault for em-dash drift (Rule 1 enforcement). Reports counts in Daily. | daily | vault → tom-king Daily/ |
| master-tasks-html | Rebuilds hosted master-tasks page from Tasks.md. Now superseded by daily-triage Cowork artefact (Rule 21 V33). | every 15 min | Tasks.md → master-tasks-tom.pages.dev (legacy) |
| notion-decisions-sync | Pushes Intelligence/decisions/ files to Notion decisions DB. Idempotent via content hash. | every 15 min | vault → Notion |
| notion-tasks-sync | Bidirectional sync between profile Tasks.md and per-person Notion kanban (Rule 22 split-path architecture). | every 15 min | vault ↔ Notion |
| os-dreaming | Reflective pass: spots audit-spawned tasks, name corrections, structural debt; queues to Tasks.md per Rule 24. | nightly | vault → Tasks.md (audit-spawned) |
| slack-ingest | Pulls Slack audio notes + text threads into Intelligence/inbox/ via Whisper transcription. | every 15 min | Slack → Intelligence/inbox/ |
| team-html | Rebuilds team-surface.pages.dev from vault data (tasks by owner, project status, blockers). | every 15 min | vault → team-surface.pages.dev |
| sync_all.sh | Master orchestrator. Runs every engine in order. Single entrypoint. | every 15 min via launchd | orchestrator |
Hosted HTML pages built from vault data on schedule, presenting state in shapes markdown can't (dashboards, kanban with WIP limits, capacity bars, status boards, calculators, indexes). Audience varies per render.
| Render | Audience | Use-moment | Path |
|---|---|---|---|
| cloudworkz-hub | Tom personal | Cross-device workstation prototype (cloudworkz-hub V1 brief still queued) | Resources/renders/cloudworkz-hub/ |
| cw-welcome-onboarding | Team-facing | Welcome / onboarding (migration to hosted HTML pending per audit cw-artefact-audit-4) | Resources/renders/cw-welcome-onboarding/ |
| transcript-ingest-explainer | Tom personal | Reference: what is the transcript-ingest skill, what's built, doc index | Resources/renders/transcript-ingest-explainer/ |
| werner-handover-brief | Werner | OS-layer handover brief, seven decisions for Werner | Resources/renders/werner-handover-brief/ |
| werner-supabase-os-blueprint | Werner / Tom | Supabase OS blueprint single-file render | Resources/renders/werner-supabase-os-blueprint.html |
| cloudworkz-os-matrix (this page) | Tom personal | System architecture matrix: what skills, what routes, how it works | Resources/renders/cloudworkz-os-matrix/ |
Live in Cowork's artefact store, not the vault. Per artefact-registry.md:
| Artefact | Purpose | Status |
|---|---|---|
tom-king-daily-triage | Live-read vault_read on open. Today / This week / Blocked. Replaces master-tasks per Rule 21 V33. | live |
tom-king-signing-off | End-of-day boilerdown artefact (4 blocks: Done today / Left / Anchor check / Housekeeping). Fires via "signing off" shortcut. | live |
vault-read-probe-v1 | Diagnostic probe artefact, reports N open tasks via vault_read. Live-read pattern proof. | live |
unlock-booker-hub, cloudworkz-os-cockpit | Audit-flagged for migration (cw-artefact-audit-5) or refresh (audit-6). | in audit |
The most common operating cycle. A meeting happens; the OS turns it into structured vault state and presents it back. Named tools at each step.
fireflies_get_transcript or as a Drive Doc reachable via search_files.transcript-ingest skill triggers automatically on Fireflies fetch, or you say intake this transcript. Pass 0 primes context via vault_read against active workstreams, team roster, recent decisions, recent meetings.Intelligence/meetings/, decisions to Intelligence/decisions/, project notes to Projects/{name}/, considerations to Intelligence/considerations/ (lazy-created) or in-note, pain points to Context/pain-points.md, strategy updates to Context/strategy.md, research stubs to Intelligence/research/, tasks to active profile's task-list/Tasks.md.notion-decisions-sync pushes the new decisions to Notion. notion-tasks-sync pushes the new tasks to the per-person kanban. daily-log-writer appends to Daily/ if anything ticked off. team-html rebuilds the team page.tom-king-daily-triage Cowork artefact reads the updated Tasks.md live on next open. The team sees the new state at team-surface.pages.dev. Decisions are searchable in Notion. The meeting note is wikilinked from every derivative.Total wall-clock from "meeting ends" to "structured state across all surfaces": about 20 minutes (transcript-ingest run + Pass 8 confirm + engines cycle). Without the skill, the same content takes hours and loses the chain.
Behavioural rules that apply to every save. Lives at .claude/rules/cloudworkz-canon.md, auto-loaded every session via paths: ['**/*.md'] frontmatter. Current V33 (26 May 2026).
| Rule | What it enforces |
|---|---|
| Rule 0 | Task Intake protocol: 5-line block before any TaskCreate (Goal / Acceptance / Capabilities / Estimate / Open questions) |
| Rule 1 | No em-dashes. Substitute with period or comma at save-time |
| Rule 2 | No files in vault root. Every file lives in an existing folder per routing |
| Rule 3 | status + 2+ tags in frontmatter for every content note |
| Rule 4 | Wikilinks for every entity (people, projects, departments, concepts) |
| Rule 9, 9a, 9b, 9c | Canonical names + roles: Marie BOOKER not Roberts, Fiorella Marketing Ops not Director, Tony ADVISOR not legal, Claudia Chavez owns Yachay (not Lambourne), CLOUDZ definition |
| Rule 15 V21 | Dual-write: every Relay-shared write is vault_write then local Write, identical content, vault_read first if not yet read this session |
| Rule 16 | Code work follows karpathy-guidelines |
| Rule 17 | Surgical by default. Don't fix adjacent rot during a content edit |
| Rule 18 | Per-step verify-checks for multi-step work |
| Rule 19 | Relay sync-recovery: BenAI Relay toggle (off, 3s, on) clears State C |
| Rule 20 | Task scoring schema: 4 dimensions (urgency emoji + e: + i: + imp:) |
| Rule 21 V33 | Session-close discipline: update Tasks.md + report delta in chat. Step 2 (artefact rebuild) retired in V33 |
| Rule 22 | Split-path tick architecture: Tom in HTML artefact, team in Notion kanban, Tasks.md canonical |
| Rule 23 | Scheduled tasks use MCP only (cloud-resident), never local-mount tools |
| Rule 24 | Audit-action contract: audits queue tasks, not just report |
| Rule 26 | Session-handoff artefact (queued for retire/ratify decision) |
| Rule 27 | Mandatory shared-folder routing. Unclassified outputs default to _scratch/ with route: pending |
| Rule 28 | Paste-and-run Terminal commands preferred when feasible |
| Rule 29 | Skills/external/ namespace for Cowork mirrors of ~/.claude/skills/ |
| Rule 30 | Don't swap the Obsidian Relay plugin without an ADR |
| Rule 31 | Never write secrets into paste-and-run shell commands |
| Rule 32 | Relay-state stamp on audit measurements |
| Rule 33 | Manifest verification at write-close (structural trigger, closed verb list) |
Phrases you say that fire defined protocols. Live in root CLAUDE.md § Shortcuts.
| Trigger | What it fires | Spec location |
|---|---|---|
| "signing off" | End-of-day boilerdown. 3-line chat headline + Cowork artefact tom-king-signing-off with 4 blocks (Done / Left / Anchor / Housekeeping) | canon § Shortcuts |
| "clean up" | Mid-session re-anchor. 6-line code-block readout (Goal / Where / Open / Drift / Debt / Next move) plus Dashboard reorder suggestion | canon § Shortcuts |
| "intake this transcript" | Ten-pass transcript-ingest skill (Pass 0 prime + Passes 1-9). Variants: process / ingest / fan this out. Auto-fires on Fireflies fetch | SKILL.md V3.1 |
Quick reference for "I need X, where does it live".
| I want to find / write... | Look at / route to |
|---|---|
| A past meeting | Intelligence/meetings/YYYY-MM-DD-{slug}.md |
| A decision someone made | Intelligence/decisions/YYYY-MM-DD-{slug}-V{n}.md |
| A research brief | Intelligence/research/YYYY-MM-DD-{slug}-V{n}.md |
| A person's profile + their tasks + their daily notes | Team/cloudworkz/Profiles/{slug}/ or Team/External/contractors/{slug}/ |
| My tasks | Team/cloudworkz/Profiles/tom-king/task-list/Tasks.md |
| Today's Daily note | Team/cloudworkz/Profiles/tom-king/Daily/YYYY-MM-DD.md |
| Strategy / OKRs | Context/strategy.md |
| Customer pain points | Context/pain-points.md |
| Tool stack | Context/infrastructure.md |
| Brand voice rules | Context/brand.md + canon Rule 9c |
| An active project | Projects/{Name}/README.md |
| A reusable framework or template | Resources/frameworks/{slug}-V{n}.md |
| A skill's spec | Skills/{slug}/SKILL.md or anthropic-skills:* in <available_skills> |
| A rule of behaviour | .claude/rules/cloudworkz-canon.md (auto-loaded) |
| A folder convention | that folder's CLAUDE.md |
| A hosted HTML view | Resources/renders/{name}/index.html |
| A scratch / work-in-progress note | _scratch/ (TTL 30 days) |